Reemplazar tender - Fire spark

Agrega un tender nuevo con replaces_tender_id apuntando a un tender real FAILED. El reemplazo se valida con las mismas reglas que el intent original. Vuelve a cobrarlo con order.payIntent().

Requiere un access token de Storefront API de Intercambio de token. El pedido ya debe estar colocado y el intent debe estar LOCKED.

En @fire-spark/storefront, llama order.replaceTender(tenderId, payment, collectAt).

Parámetros de ruta

Parámetro	Requerido	Descripción
`id`	Sí	Identificador externo del pedido
`tenderId`	Sí	Identificador del tender fallido

Cuerpo de la solicitud

Campo	Requerido	Descripción
`method`	Sí	Método de reemplazo
`payment_id`	Sí	Id del pago del merchant
`provider`	Sí	Id de proveedor del catálogo
`collect_at`	Sí	`DEVICE`, `KIOSK`, `COUNTER`, `DOOR` u `OTHER`

curl -X POST "https://firespark.cloud/api/storefront/v1/orders/ord-48291/tenders/tnd-card-1/replace" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "CASH",
    "payment_id": "3b1c8f2e-5a44-4d1b-9c0e-2f6a1d8b7e90",
    "provider": "firespark",
    "collect_at": "COUNTER"
  }'

Respuesta

Devuelve 200 con el pedido. El tender nuevo queda en el intent bloqueado.

Respuestas de error

Estado	Descripción
`404`	Pedido o tender vivo no encontrado
`409`	El tender no está `FAILED`, o el pedido sigue `OPEN` (`details.code: PAYMENT_INTENT_LOCKED`)
`422`	El reemplazo no pasa las mismas validaciones que Guardar intent de pago